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1. Introduction 


There have been many additions and modifications to the UNIX Operating System for the 
System V release. Generally, additions are always welcome to any effort. However, some changes 
require the administrator or user to change files or procedures used in the normal operation or 
configuration of the system. This document highlights those features in System V which might 
change the operation of the system. It does not include all the features in System V. For a 
complete list of features and enhancements you should consult the System V Prospectus. 


2. Device Drivers 
2.1 General Disk Driver 


The general disk driver supports several different standard disks (RPO4/5/6, RPO7, RM80, RM05) 
on a single controller and will also support up to 4 controllers. The gd(7) driver is available for 
both the DEC* VAX* and PDP*-11 lines. These devices are specified by the label disk in the 
configuration file. 


2.2 General Tape Driver 


The general tape driver supports the TE16/TM03, TU77/TMO3, and TU78/TM78 MASSBUS'! tape 
drive/controller pairs. The new gt(7) driver replaces the older hr (4) driver for the TE16/TMO3 tape 
drive/controller on the VAX line only. These devices are specified by the label tu1678 in the 
configuration file. 


2.3 KMC/DZ Asynchronous Line Interface 


The KMC11-A is no longer supported as the UNIBUS? controller. This controller only had 1K byte 
of memory and was not suitable for handling both input and output. The System III version of the 
DZ/KMC driver only used the KMC for output to the DZ. The KMC11-B is fully supported for DZ 
assist, and the interface is now much more efficient in passing characters back to the cpu (input). 
The DZ devices are specified by the label dzb in the configuration file. 


2.4 Bdevsw, Cdevsw, Lime Disciplines, etc... 


For those interested in moving device drivers from System III to System V, note that there have 
been changes to the file /usr/include/sys/conf.h. The following information is not 
comprehensive enough to make the required changes, a detailed look into the operation of the 
drivers is required. 

The pointer to the system I/O buffers has been removed from bdevsw because the buffers are 
hashed by device number. In a separate change, a pointer to a new routine is now present, 
d_print to provide a uniform error message printing routine. The pointer to the struct 
tty in cdevsw andthe new struct termsw were added to handle multiple line disciplines. 
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3. File System 


The file system structure has been enhanced to increase performance but maintains compatibility 
with the System III file system. The new file systems use a 1K byte block size, but the older 
System III, 512 bytes per block file systems may still be mounted and used, as is. The new 1K byte 
block size reduces the number and time of accesses to the disk. The system buffers have been 
expanded to support the 1K byte block size. The operating system distinguishes between the two 
types of file system and handles them with no discernible difference to the user other than 
performance. 


The key to the difference in format is contained in struct filsys in 
/asr/include/sys/filsys.h which describes the super-block. The boot-block and the 
super-block are in the same place and are the same size for both file system structures. The boot- 
block is the first 512 bytes of a file system and the super-block is the next 512 bytes. In struct 
f£ilsys there are two elements, s_magic and s_type, used for file system size identification. 
New file systems created by /etc/mkfs (for 1K byte blocks) or /etc/omkfs (for 512 byte blocks) 
have s magic set to FsMAGIC. For IK byte file systems the element s_ type will be set to 
Fs2b and for 512 byte file systems the element s_type will be set to Fsib. If s magic is 
not set to FsMAGIC the file system is assumed to be of the "old" 512 byte block variety. 


Except for the boot and super blocks (blocks numbered 0 and 1), all other blocks in the file system 
are found at a byte offset equal to their block number multiplied by the size, in bytes, of the logical 
file system block. 


There are very few commands which are affected by the difference in file system block size. These 
commands are usually involved in generating or reporting the sizes of file systems (e.g. mkfs(1M), 
fsck(1M), df(1M)). For compatibility these commands still report sizes in 512 byte blocks. In 
general there is no reason for a user to be concerned with the type of file system being dealt with. 
The labelit command (see volcopy(1M)) now reports the file system block size. 


3.1 Initial Boot 


System V will be delivered with 1K byte block root (/) and user (/usr) file systems. After the 
new system is read in and booted, the system administrator may copy local files from the site 
backups. Any of the standard UNIX system tools may be used to transfer the old files to the new 
file system. Care should be taken not to overwrite the new file system check program fsck(1M) or 
any of the accounting programs. In general it is wise not to overwrite any of the files delivered with 
the new system (except those intended for local modification). 


3.2 Performance w. Space 


To choose whether to keep an old file system with 512 byte blocks or generate a new 1K byte file 
system, trade-off decisions must be made. The larger size file system provides better performance 
than the older file system because of the reduction of the number of disk seeks per file read. In 
addition, the buffers in System V have all been increased to support the larger file system so that 
use of a small block file system means that half of the system buffer space will be wasted for those 
blocks that are buffered (one buffer block is used per file system block regardless of the size of the 
file system block). On the other hand, a file system with a large number of small files (< 512 
bytes) will have more disk space wasted if converted to the large block file system. In fact, small 
block file systems that are almost full may not fit on a large block file system using the same disk 
space. A transition tool fsba(1M) is supplied with System V to assist the administrator. Fsba 
measures the size of a 512 byte file system and estimates the number of physical (512 byte) blocks 
and the number of inodes required to make a 1K byte/block file system. Documentation 
accompanies this program explaining its function and use more thoroughly. The performance vs. 
space decision must be made by the system administrator before converting file systems. 


3.3 Conversion of Existing File Systems 


Any of the existing file systems may be converted to the larger block size. Since existing file 
systems are supported by System V, no special conversion tools are necessary. Files resident under 
an old file system may be copied to a new (1K byte block) file system using cpio(1) and find(1) or 
the finc(1M) and frec(1M) routines. Do not use volcopy(1M), as this command will restore a 
complete file system, including the small block structure. 


3.3.1 Cautions Because of the possibility of additional wasted space on 1K byte block file systems, 
conversion of full and nearly full 512 byte block file systems may not be possible. Refer to the 
program fsba(1M) (file system block analyzer) to supply you with a summary of the space usage on 
a small block file system and a projection of the usage on a large block file system. 


Also, because cpio(1) has a limit to the number of unique linked files it can remember, care must 
be taken when converting a file system with a large number of these files. 


3.4 Re-Compilation of Users’ Software 


User code and application code that uses the standard I/O library should be recompiled to take 
advantage of the larger buffer size of the new library. The increase in size of the file system block 
and the standard I/O buffer are independent of each other in an operational sense. The recompiled 
code is fully compatible with both file systems and will be more efficient even when using 512 byte 
file systems. 


3.5 Modification of Users’ Software 


User and application code not using standard I/O or doing its own buffering may need to be 
changed to take advantage of the new file system. Internal buffers used for I/O should be set to be 
a multiple of 1024 bytes so that they will efficiently match the internal buffer size of System V. 
The buffer size may be specified (in a portable way) by using the define constant BUFSIZ from 
the header fille /usr/include/stdio.h. 


User code and application code that accesses file systems directly must be examined (and probably 
changed) and recompiled so that they are in accord with the new file system structure. 


4. Init & Getty 
4.1 Init 


The entries in the /etc/inittab (see inittab(S)) file have been changed as part of the new interface, 
so that it is not possible to use the old /etc/inittab file. More states are now possible for spawning 
programs, and users should read the manual page carefully to select the proper action when a 
process terminates. Changing from multi-user state to single-user state is done by using init as a 
command, however; the single-user state is now called s (instead of 1) so that the command 


init s 
or 
init § 


brings the system into single user mode. When changes are made to /etc/inittab, the administrator 
now uses the command 


init q 


to signal the init process of the change. The shell script shutdown(1M) is provided for the 
administrator to bring the system down to the single-user state gracefully. A command file /etc/brc 
(see brc(1M)) is now executed after the system is booted so that commands to download devices 
should be placed here. A similar file /etc/powerfail (see brc(1M)) is available for power fail. The 
sections for downloading device controllers (e.g. KMC11-B) and performing power failure recovery 
formerly appeared in the /etc/rc file. 


In System III the file /etc/rc was called with three arguments so that the current state of the 
machine was known. The three arguments passed to /etc/rc in System III, the current state, the 
number of times in that state (previously), and the previous state are no longer passed directly to 
/etc/rc. This information is now generally available as the seventh, eighth and ninth fields of the 
command who -«r. The following lines can be inserted at the beginning of the /etc/rc file so the 
positional parameters are at the same location as they are in System III. 


set ‘who -r* 
shift 6 


Note, when checking for single-user state the character ‘S’ should be used, not ‘1’. For example, 
later in the same file one might have: 


if [— ($1 = 2) -a ($2 = 0) Jj 

then 

# commands for first time in multi-user state 

fi 
This will execute commands the first time the system is in state 2 (generally multi-user mode) after 
a reboot. 
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The line speed table is now in the file /etc/gettydefs, so that the sequence of line speeds can be 
edited online. (No recompilation of the getty(1M) command is necessary.) 


The /etc/gettydefs file can be checked using the ‘-c’ option of the getty command. The options to 
getty are slightly different and are described in the manual pages. 


43 Related Charges 


Because of the changes to init, the format and location of the /etc/utmp and /etc/wtmp files are not 
compatible with previous systems. Users who have written private copies of commands that use 
these files should be prepared to adopt the new format described in utmp(4). Library routines 
@getut (3c)) are provided to ease the conversion. 


3. PDP-11 Overlay Loader 


This loader was specifically modified for the PDP-11 operating system (OS). It is called by the 
makefile for the operating system and permits the use of an OS which is larger than the amount of 
memory that can be handled by the kernel memory management registers. This is not a true 
overlay loader in that there must be enough physical memory for the entire OS. Only the texr 
portion of the OS is managed in this way, so that a limitation of 56K bytes must still be observed 
for the data space. The loader and associated software manipulate the memory management 
registers to access a larger amount of memory than is normally available to the kernel instruction 
space. The loader is given the names of the routines which will be ‘overlay loaded’, generally these 
are device drivers. 


A previously unused byte is used in the object file header to store the increased size. There were 
several commands (e.g. size, sum) that were changed to recognize this size change. 


6. Configuration 


There are several additional parameters that must be specified and assigned values when making a 
‘new OS. The parameters are explained in the Setting Up Unix document. 


6.1 Hashkbef 


This parameter specifies the number of hash buckets to allocate for the hashing of the system 
buffers. 


6.2 Iblocks (PDP-11 oaly) 


The inode data block address cache was implemented on the PDP-11 to conserve data space by 
permitting the administrator to allocate the data block pointers separately from the inodes. An 
iblock is needed for each regular, directory, and fifo file that is open. Block and character special 
files do not need iblocks. 


